<!DOCTYPE html>
<html lang="en" class="svg no-js">
<head>
    <meta charset="utf-8" />
    <!--[if IE ]>
    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1" />
    <![endif]-->
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta name="Language" content="en">

    <title>MySQL :: MySQL 8.0 Reference Manual :: 4.5.8 mysqlslap — Load Emulation Client</title>
    <link rel="stylesheet" media="all" href="css/main-20190125.min.css" />
            <link rel="stylesheet" media="all" href="css/docs-20190125.min.css" />
    
    
    <link rel="stylesheet" media="print" href="css/print-20190125.min.css" />

    
    
    
    
            <link rel="contents" href="index.html" title="MySQL 8.0 Reference Manual" />
<link rel="start" href="index.html" title="MySQL 8.0 Reference Manual" />
<link rel="prev" href="mysqlshow.html" title="4.5.7 mysqlshow &mdash; Display Database, Table, and Column Information" />
<link rel="next" href="programs-admin-utils.html?ff=nopfpls" title="4.6 MySQL Administrative and Utility Programs" />
<link rel="up" href="programs-client.html" title="4.5 MySQL Client Programs" />

    
    <link rel="shortcut icon" href="favicon.ico" />
    <script>(function(H){ H.className=H.className.replace(/\bno-js\b/,'js') })(document.documentElement)</script>
    <script src="js/site-20181120.min.js"></script>

    
    
    
    <!--[if lt IE 9]>
        <script src="https://labs.mysql.com/common/js/polyfills/html5shiv-printshiv-3.7.2.min.js"></script>
        <script src="https://labs.mysql.com/common/js/polyfills/respond-1.4.2.min.js"></script>
    <![endif]-->
        <!--[if IE 9]>
        <style>#docs-sidebar-toc { box-sizing: content-box; }</style>
    <![endif]-->
    </head>

<body class="no-sidebar full-page dev">
<div class="page-wrapper">
    <header>

                        <a href="https://dev.mysql.com/" aria-label="Home" title="MySQL" id="l1-home-link"></a>
        
        <div id="l1-nav-container">
            <div id="l1-line1">
                <div id="l1-auth-links">
                    <a href="https://www.mysql.com/about/contact/"><b>Contact MySQL</b></a>
                    <span id="l1-contact-separator">&nbsp;|&nbsp;</span>
                    <span id="l1-contact-separator-br"><br /></span>
                                             <a href="https://dev.mysql.com/auth/login/?dest=https%3A%2F%2Fdev.mysql.com%2Fdoc%2Frefman%2F8.0%2Fen%2Fmysqlslap.html">Login</a> &nbsp;|&nbsp;
                         <a href="https://dev.mysql.com/auth/register/">Register</a>
                                    </div>
                <div id="l1-lhs">
                    <div id="l1-slogan">
                        The world's most popular open source database
                    </div>
                    <div id="l1-search-box">
                        <form id="l1-search-form" method="get" action="https://www.oracle.com/search/results">
                        <input type="hidden" name="cat" value="mysql" />
                        <input type="hidden" name="Ntk" value="SI-ALL5" />
                        <input id="l1-search-input" type="search" class="icon-search" placeholder="Search" aria-label="Search" name="Ntt" />
                        </form>
                    </div>
                </div>
            </div>
            <div id="l1-line2">
                <div class="social-icons">
                    <a aria-label="Join us on Facebook" title="Join us on Facebook" href="http://www.facebook.com/mysql"><span class="icon-facebook"></span></a>
                    <a aria-label="Follow us on Twitter" title="Follow us on Twitter" href="https://twitter.com/mysql"><span class="icon-twitter"></span></a>
                    <a aria-label="Follow us on LinkedIn" title="Follow us on LinkedIn" href="https://www.linkedin.com/company/mysql"><span class="icon-linkedin"></span></a>
                    <a aria-label="Visit our YouTube channel" title="Visit our YouTube channel" href="http://www.youtube.com/mysqlchannel"><span class="icon-youtube"></span></a>
                </div>
                <ul id="l1-nav">
                    <li>
                        <a href="https://www.mysql.com/"><!-- <span class="icon-sakila"></span>  -->MySQL.com</a>
                    </li><li>
                        <a href="https://www.mysql.com/downloads/"><!-- <span class="icon-download-thin"></span>  -->Downloads</a>
                    </li><li class="active">
                        <a href="/doc/"><!-- <span class="icon-books"></span>  -->Documentation</a>
                    </li><li>
                        <a href="/"><!-- <span class="icon-code"></span>  -->Developer Zone</a>
                    </li>                </ul>
            </div>
        </div>
        <div id="sub-header">
            <div id="l2-nav-container">
                <div id="l2-nav-toggle">
                    <span class="icon-three-bars"></span>
                </div>
                                                                                        <a class="button nav-button-3" href="/"><span class="icon-code"></span> Developer Zone</a>
                                                                                                                                    <a class="button nav-button-2" href="https://www.mysql.com/downloads/"><span class="icon-download-thin"></span> Downloads</a>
                                                                                                <a class="button nav-button-1" href="https://www.mysql.com/"><span class="icon-sakila"></span> MySQL.com</a>
                                                                        <div id="l2-search-toggle">
                    <span class="icon-search"></span>
                </div>
                <div id="l2-site-icon">
                                                                                                                                                                                                    <span class="icon-books"></span>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        </div>
                <div id="l1-section-title">
                    <span id="l1-section-label">
                        <a href="/doc/">Documentation</a>
                    </span>
                </div>
                <nav>
                    

<ul id="l2-nav">
            	<li class="active"><a class="active " href="/doc/refman/en/">MySQL Server</a>
    			</li>
	        	<li class=""><a  href="/doc/index-enterprise.html">MySQL Enterprise</a>
    			</li>
	        	<li class=""><a  href="/doc/workbench/en/">Workbench</a>
    			</li>
	        	<li class=""><a  href="/doc/en/mysql-innodb-cluster-userguide.html">InnoDB Cluster</a>
    			</li>
	        	<li class=""><a  href="/doc/index-cluster.html">MySQL NDB Cluster</a>
    			</li>
	        	<li class=""><a  href="/doc/index-connectors.html">Connectors</a>
    			</li>
	        	<li class=" last"><a  href="/doc/index-other.html">More</a>
    			</li>
	                        <li class="other-section"><a href="https://www.mysql.com/">MySQL.com</a></li>
                            <li class="other-section"><a href="https://www.mysql.com/downloads/">Downloads</a></li>
                                        <li class="other-section"><a href="/">Developer Zone</a></li>
            </ul>
                </nav>
            </div>
            <div id="l3-search-container"></div>
            <div id="top-orange"><span id="section-nav">Section Menu: &nbsp; </span></div>
        </div>
    </header>
        <div id="page">
                        <div role="main" id="main">

            
                
            
<div>
    <div id="docs-sidebar-toc" class="">
    <div id="docs-toc-inner">
        <div class="docs-sidebar-header" id="docs-nav-header">
            <a class="docs-show-hide-nav" id="docs-hide-nav" href="" title="Hide Sidebar" aria-label="Hide Sidebar"><span class="icon-arrow-small-left"></span></a>
            <div class="docs-nav-links">
                                    
    <a href="mysqlshow.html"
        aria-label="Previous" title="Previous: mysqlshow — Display Database, Table, and Column Information"><span
        class="icon-chevron-left"></span></a>
<a href="index.html" aria-label="Start" title="Start"><span class="icon-book-open"></span></a>
        <a aria-label="Up" href="programs-client.html" title="Up: MySQL Client Programs"><span class="icon-chevron-up"></span></a>
    <a href="programs-admin-utils.html" aria-label="Next"
        title="Next: MySQL Administrative and Utility Programs"><span
        class="icon-chevron-right"></span></a>
                            </div>
        </div>
                    
<div id="docs-sidebar-search-container">
    <div id="docs-sidebar-search-box">
        <form method="get" action="/mysql-manual/search-page">
            <input type="hidden" name="d" id="d" value="201" />
            <input type="hidden" name="p" id="p" value="1" />
            <input type="text" name="keyword" id="q" title="Search this Manual"
                value=""
                style="color: #bbb;"
                onfocus=""
                onblur="" />

            <button class="docs-sidebar-search-btn" aria-label="Search" title="Search" type="submit">
                <span class="icon-search"></span>
            </button>
        </form>
    </div>
</div>
                <div class="docs-sidebar-nav">
            <a class="docs-icon-home" href="/doc/"><span class="icon-home"></span>Documentation Home</a><hr />
            <div class="docs-sidebar-mtitle">MySQL 8.0 Reference Manual</div>
            <nav class="doctoc" id="doc-201">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="preface.html">Preface and Legal Notices</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="introduction.html">General Information</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="installing.html">Installing and Upgrading MySQL</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="tutorial.html">Tutorial</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-down"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs.html">MySQL Programs</a></div></div>                        <div class="docs-submenu">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="programs-overview.html">Overview of MySQL Programs</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-using.html">Using MySQL Programs</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="invoking-programs.html">Invoking MySQL Programs</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="program-options.html">Specifying Program Options</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="command-line-options.html">Using Options on the Command Line</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="option-files.html">Using Option Files</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="option-file-options.html">Command-Line Options that Affect Option-File Handling</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="option-modifiers.html">Program Option Modifiers</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="program-variables.html">Using Options to Set Program Variables</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="option-defaults-equals.html">Option Defaults, Options Expecting Values, and the = Sign</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="connection-options.html">Command Options for Connecting to the Server</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="connecting.html">Connecting to the MySQL Server Using Command Options</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="connecting-using-uri-or-key-value-pairs.html">Connecting to the Server Using URI-Like Strings or Key-Value Pairs</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="connection-compression-control.html">Connection Compression Control</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="setting-environment-variables.html">Setting Environment Variables</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-server.html">MySQL Server and Server-Startup Programs</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqld.html">mysqld — The MySQL Server</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqld-safe.html">mysqld_safe — MySQL Server Startup Script</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-server.html">mysql.server — MySQL Server Startup Script</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqld-multi.html">mysqld_multi — Manage Multiple MySQL Servers</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-installation.html">MySQL Installation-Related Programs</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="comp-err.html">comp_err — Compile MySQL Error Message File</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-secure-installation.html">mysql_secure_installation — Improve MySQL Installation Security</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-ssl-rsa-setup.html">mysql_ssl_rsa_setup — Create SSL/RSA Files</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-tzinfo-to-sql.html">mysql_tzinfo_to_sql — Load the Time Zone Tables</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-upgrade.html">mysql_upgrade — Check and Upgrade MySQL Tables</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-down"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-client.html">MySQL Client Programs</a></div></div>                        <div class="docs-submenu">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="mysql.html">mysql — The MySQL Command-Line Client</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-command-options.html">mysql Client Options</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-commands.html">mysql Client Commands</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-logging.html">mysql Client Logging</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-server-side-help.html">mysql Client Server-Side Help</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-batch-commands.html">Executing SQL Statements from a Text File</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-tips.html">mysql Client Tips</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqladmin.html">mysqladmin — Client for Administering a MySQL Server</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlcheck.html">mysqlcheck — A Table Maintenance Program</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqldump.html">mysqldump — A Database Backup Program</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlimport.html">mysqlimport — A Data Import Program</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlpump.html">mysqlpump — A Database Backup Program</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlshow.html">mysqlshow — Display Database, Table, and Column Information</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link current"><a href="mysqlslap.html">mysqlslap — Load Emulation Client</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-admin-utils.html">MySQL Administrative and Utility Programs</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="ibd2sdi.html">ibd2sdi — InnoDB Tablespace SDI Extraction Utility</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="innochecksum.html">innochecksum — Offline InnoDB File Checksum Utility</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisam-ftdump.html">myisam_ftdump — Display Full-Text Index information</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="myisamchk.html">myisamchk — MyISAM Table-Maintenance Utility</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamchk-general-options.html">myisamchk General Options</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamchk-check-options.html">myisamchk Check Options</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamchk-repair-options.html">myisamchk Repair Options</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamchk-other-options.html">Other myisamchk Options</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamchk-table-info.html">Obtaining Table Information with myisamchk</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamchk-memory.html">myisamchk Memory Usage</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisamlog.html">myisamlog — Display MyISAM Log File Contents</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="myisampack.html">myisampack — Generate Compressed, Read-Only MyISAM Tables</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-config-editor.html">mysql_config_editor — MySQL Configuration Utility</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="mysqlbinlog.html">mysqlbinlog — Utility for Processing Binary Log Files</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlbinlog-hexdump.html">mysqlbinlog Hex Dump Format</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlbinlog-row-events.html">mysqlbinlog Row Event Display</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlbinlog-backup.html">Using mysqlbinlog to Back Up Binary Log Files</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqlbinlog-server-id.html">Specifying the mysqlbinlog Server ID</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysqldumpslow.html">mysqldumpslow — Summarize Slow Query Log Files</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-development.html">MySQL Program Development Utilities</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-config.html">mysql_config — Display Options for Compiling Clients</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="my-print-defaults.html">my_print_defaults — Display Options from Option Files</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable  loaded" aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="programs-miscellaneous.html">Miscellaneous Programs</a></div></div>                        <div class="docs-submenu hidden">
                                    
    <ul>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="lz4-decompress.html">lz4_decompress — Decompress mysqlpump LZ4-Compressed Output</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="perror.html">perror — Display MySQL Error Message Information</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="zlib-decompress.html">zlib_decompress — Decompress mysqlpump ZLIB-Compressed Output</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="environment-variables.html">MySQL Environment Variables</a></div></div>                    </li>
        </ul>
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="server-administration.html">MySQL Server Administration</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="security.html">Security</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="backup-and-recovery.html">Backup and Recovery</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="optimization.html">Optimization</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="language-structure.html">Language Structure</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="charset.html">Character Sets, Collations, Unicode</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="data-types.html">Data Types</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="functions.html">Functions and Operators</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="sql-syntax.html">SQL Statement Syntax</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="data-dictionary.html">MySQL Data Dictionary</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="innodb-storage-engine.html">The InnoDB Storage Engine</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="storage-engines.html">Alternative Storage Engines</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="replication.html">Replication</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="group-replication.html">Group Replication</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="mysql-shell-userguide.html">MySQL Shell</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="document-store.html">Using MySQL as a Document Store</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="mysql-innodb-cluster-userguide.html">InnoDB Cluster</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="mysql-cluster.html">MySQL NDB Cluster 8.0</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="partitioning.html">Partitioning</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="stored-objects.html">Stored Objects</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="information-schema.html">INFORMATION_SCHEMA Tables</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="performance-schema.html">MySQL Performance Schema</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="sys-schema.html">MySQL sys Schema</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="connectors-apis.html">Connectors and APIs</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="extending-mysql.html">Extending MySQL</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="mysql-enterprise.html">MySQL Enterprise Edition</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="workbench.html">MySQL Workbench</a></div></div>                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="faqs.html">MySQL 8.0 Frequently Asked Questions</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="error-handling.html">Errors, Error Codes, and Common Problems</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="restrictions.html">Restrictions and Limits</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><a class="expandable " aria-label="Subnav" href=""><span class="icon-chevron-right"></span></a></div><div class="docs-sidebar-nav-link"><a href="indexes.html">Indexes</a></div></div>                        <div class="docs-submenu hidden">
                            </div>
                    </li>
            <li>
            <div><div class="docs-sidebar-nav-icon"><span class="icon-dot"></span></div><div class="docs-sidebar-nav-link"><a href="glossary.html">MySQL Glossary</a></div></div>                    </li>
        </ul>
                            </nav>
        </div>

        
<a class="docs-sidebar-section" href=""><span class="icon-related"></span>
    <span class="text">Related Documentation</span></a>
<div class="docs-sidebar-accordian open">
    <div class="text">
        <a href="/doc/relnotes/mysql/8.0/en/">MySQL 8.0 Release Notes</a><br />
        <a href="/doc/dev/mysql-server/latest/">MySQL 8.0 Source Code Documentation</a><br />
        </div>
</div>

    <a class="docs-sidebar-section" href=""><span class="icon-download-thin"></span>
        <span class="text">
            Download
                            this Manual
                    </span>
    </a>
    <div class="docs-sidebar-accordian open">
        <div class="text">
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.pdf">PDF (US Ltr)</a>
            - 46.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.a4.pdf">PDF (A4)</a>
            - 46.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-ref-manual-8.0-en-pdf-1-20190611.noarch.rpm">PDF (RPM)</a>
            - 41.5Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.html-chapter.tar.gz">HTML Download (TGZ)</a>
            - 10.6Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.html-chapter.zip">HTML Download (Zip)</a>
            - 10.6Mb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-ref-manual-8.0-en-html-chapter-1-20190611.noarch.rpm">HTML Download (RPM)</a>
            - 9.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.man-gpl.tar.gz">Man Pages (TGZ)</a>
            - 220.4Kb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.man-gpl.zip">Man Pages (Zip)</a>
            - 325.8Kb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-8.0.info.gz">Info (Gzip)</a>
            - 4.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-8.0.info.zip">Info (Zip)</a>
            - 4.1Mb<br />
                    </div>
    </div>

<a class="docs-sidebar-section" href=""><span class="icon-book"></span>
    <span class="text">Excerpts from this Manual</span></a>
<div class="docs-sidebar-accordian">
    <div class="text">
                <a href="/doc/mysql-backup-excerpt/8.0/en/">MySQL Backup and Recovery</a><br />
                <a href="/doc/mysql-g11n-excerpt/8.0/en/">MySQL Globalization</a><br />
                <a href="/doc/mysql-infoschema-excerpt/8.0/en/">MySQL Information Schema</a><br />
                <a href="/doc/mysql-installation-excerpt/8.0/en/">MySQL Installation Guide</a><br />
                <a href="/doc/mysql-security-excerpt/8.0/en/">Security in MySQL</a><br />
                <a href="/doc/mysql-startstop-excerpt/8.0/en/">Starting and Stopping MySQL</a><br />
                <a href="/doc/mysql-linuxunix-excerpt/8.0/en/">MySQL and Linux/Unix</a><br />
                <a href="/doc/mysql-windows-excerpt/8.0/en/">MySQL and Windows</a><br />
                <a href="/doc/mysql-osx-excerpt/8.0/en/">MySQL and OS X</a><br />
                <a href="/doc/mysql-solaris-excerpt/8.0/en/">MySQL and Solaris</a><br />
                <a href="/doc/mysql-sourcebuild-excerpt/8.0/en/">Building MySQL from Source</a><br />
                <a href="/doc/mysql-reslimits-excerpt/8.0/en/">MySQL Restrictions and Limitations</a><br />
                <a href="/doc/mysql-partitioning-excerpt/8.0/en/">MySQL Partitioning</a><br />
                <a href="/doc/mysql-secure-deployment-guide/8.0/en/">MySQL Secure Deployment Guide</a><br />
                <a href="/doc/mysql-tutorial-excerpt/8.0/en/">MySQL Tutorial</a><br />
                <a href="/doc/mysql-perfschema-excerpt/8.0/en/">MySQL Performance Schema</a><br />
                <a href="/doc/mysql-replication-excerpt/8.0/en/">MySQL Replication</a><br />
                <a href="/doc/mysql-repo-excerpt/8.0/en/">Using the MySQL Yum Repository</a><br />
            </div>
</div>

        <br /><span id="wkr"><br /></span>
    </div>
    </div>

    <div id="docs-main" class="has-toc">
    <div id="docs-main-inner">

                <div class="right" id="docs-version-nav">
            <a href="" id="docs-version-nav-toggle">version 8.0
            <span class="icon-chevron-down"></span></a>
            <div id="docs-version-list">
                                                                                            <a                         href="/doc/refman/5.7/en/mysqlslap.html">
                        5.7
                                            </a><br />
                                                                            <a                         href="/doc/refman/5.6/en/mysqlslap.html">
                        5.6
                                            </a><br />
                                                                            <a                         href="/doc/refman/5.5/en/mysqlslap.html">
                        5.5
                                            </a><br />
                                                                        <div id="docs-version-nav-lang">
                                                                                                                                                    <a                                     href="/doc/refman/5.6/ja/mysqlslap.html">
                                    5.6&nbsp;
                                                                            Japanese
                                                                    </a><br />
                                                                                            </div>
                            </div>
        </div>
        
        <div id="docs-show-nav" class="left hidden" style="margin-right: 15px;">
            <a class="docs-show-hide-nav" href="" aria-label="Show Sidebar"
                title="Show Sidebar"><span class="icon-arrow-small-right"></span></a>
        </div>

                        <div id="docs-breadcrumbs">
            <a href="/doc/refman/8.0/en/">MySQL 8.0 Reference Manual</a> &nbsp;/&nbsp;
                            <span id="breadcrumbs-link"><a href="" id="show-breadcrumbs">...</a> &nbsp;/&nbsp;</span>
                <span class="hidden" id="hidden-breadcrumbs">
                                                        <a href="programs.html">MySQL Programs</a> &nbsp;/&nbsp;
                                                            <a href="programs-client.html">MySQL Client Programs</a> &nbsp;/&nbsp;
                                                                                        </span>
                                        mysqlslap — Load Emulation Client
                                    </div>
        
        <div id="docs-body">
        
<div class="section">
<div class="titlepage">
<div>
<div>
<h3 class="title"><a name="mysqlslap"></a>4.5.8 <span class="command"><strong>mysqlslap</strong></span> — Load Emulation Client</h3>

</div>

</div>

</div>
<a class="indexterm" name="idm139663282361904"></a><a class="indexterm" name="idm139663282360960"></a><p>
        <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> is a diagnostic program designed to
        emulate client load for a MySQL server and to report the timing
        of each stage. It works as if multiple clients are accessing the
        server.
      </p><p>
        Invoke <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> like this:
      </p><pre class="programlisting copytoclipboard line-numbers language-terminal one-line"><code class="language-terminal">shell&gt; mysqlslap [<em class="replaceable">options</em>]</code></pre><p>
        Some options such as <a class="link" href="mysqlslap.html#option_mysqlslap_create"><code class="option">--create</code></a>
        or <a class="link" href="mysqlslap.html#option_mysqlslap_query"><code class="option">--query</code></a> enable you to
        specify a string containing an SQL statement or a file
        containing statements. If you specify a file, by default it must
        contain one statement per line. (That is, the implicit statement
        delimiter is the newline character.) Use the
        <a class="link" href="mysqlslap.html#option_mysqlslap_delimiter"><code class="option">--delimiter</code></a> option to specify
        a different delimiter, which enables you to specify statements
        that span multiple lines or place multiple statements on a
        single line. You cannot include comments in a file;
        <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> does not understand them.
      </p><p>
        <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> runs in three stages:
</p>
<div class="orderedlist">
<ol class="orderedlist" type="1"><li class="listitem"><p>
            Create schema, table, and optionally any stored programs or
            data to use for the test. This stage uses a single client
            connection.
          </p></li><li class="listitem"><p>
            Run the load test. This stage can use many client
            connections.
          </p></li><li class="listitem"><p>
            Clean up (disconnect, drop table if specified). This stage
            uses a single client connection.
</p></li></ol>
</div>
<p>
        Examples:
      </p><p>
        Supply your own create and query SQL statements, with 50 clients
        querying and 200 selects for each (enter the command on a single
        line):
      </p><pre class="programlisting copytoclipboard line-numbers language-terminal"><code class="language-terminal">mysqlslap --delimiter=";"
  --create="CREATE TABLE a (b int);INSERT INTO a VALUES (23)"
  --query="SELECT * FROM a" --concurrency=50 --iterations=200</code></pre><p>
        Let <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> build the query SQL statement
        with a table of two <a class="link" href="integer-types.html" title="11.2.1 Integer Types (Exact Value) - INTEGER, INT, SMALLINT, TINYINT, MEDIUMINT, BIGINT"><code class="literal">INT</code></a> columns
        and three <a class="link" href="char.html" title="11.4.1 The CHAR and VARCHAR Types"><code class="literal">VARCHAR</code></a> columns. Use
        five clients querying 20 times each. Do not create the table or
        insert the data (that is, use the previous test's schema and
        data):
      </p><pre class="programlisting copytoclipboard line-numbers language-terminal"><code class="language-terminal">mysqlslap --concurrency=5 --iterations=20
  --number-int-cols=2 --number-char-cols=3
  --auto-generate-sql</code></pre><p>
        Tell the program to load the create, insert, and query SQL
        statements from the specified files, where the
        <code class="filename">create.sql</code> file has multiple table creation
        statements delimited by <code class="literal">';'</code> and multiple
        insert statements delimited by <code class="literal">';'</code>. The
        <code class="option">--query</code> file will have multiple queries
        delimited by <code class="literal">';'</code>. Run all the load
        statements, then run all the queries in the query file with five
        clients (five times each):
      </p><pre class="programlisting copytoclipboard line-numbers language-terminal"><code class="language-terminal">mysqlslap --concurrency=5
  --iterations=5 --query=query.sql --create=create.sql
  --delimiter=";"</code></pre><p>
        <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> supports the following options,
        which can be specified on the command line or in the
        <code class="literal">[mysqlslap]</code> and <code class="literal">[client]</code>
        groups of an option file. For information about option files
        used by MySQL programs, see <a class="xref" href="option-files.html" title="4.2.2.2 Using Option Files">Section 4.2.2.2, “Using Option Files”</a>.
</p>
<div class="table">
<a name="idm139663282327200"></a><p class="title"><b>Table 4.17 mysqlslap Options</b></p>
<div class="table-contents">
<table frame="box" rules="all" summary="Command-line options available for mysqlslap."><col width="27%"><col width="50%"><col width="11%"><col width="11%"><thead><tr><th scope="col">Option Name</th>
<th scope="col">Description</th>
<th scope="col">Introduced</th>
<th scope="col">Removed</th>
</tr></thead><tbody><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql">--auto-generate-sql</a></td>
<td>Generate SQL statements automatically when they are not supplied in files or using command options</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-add-autoincrement">--auto-generate-sql-add-autoincrement</a></td>
<td>Add AUTO_INCREMENT column to automatically generated tables</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-execute-number">--auto-generate-sql-execute-number</a></td>
<td>Specify how many queries to generate automatically</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-guid-primary">--auto-generate-sql-guid-primary</a></td>
<td>Add a GUID-based primary key to automatically generated tables</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-load-type">--auto-generate-sql-load-type</a></td>
<td>Specify the test load type</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-secondary-indexes">--auto-generate-sql-secondary-indexes</a></td>
<td>Specify how many secondary indexes to add to automatically generated tables</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-unique-query-number">--auto-generate-sql-unique-query-number</a></td>
<td>How many different queries to generate for automatic tests.</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-unique-write-number">--auto-generate-sql-unique-write-number</a></td>
<td>How many different queries to generate for --auto-generate-sql-write-number</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-write-number">--auto-generate-sql-write-number</a></td>
<td>How many row inserts to perform on each thread</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_commit">--commit</a></td>
<td>How many statements to execute before committing.</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_compress">--compress</a></td>
<td>Compress all information sent between client and server</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_concurrency">--concurrency</a></td>
<td>Number of clients to simulate when issuing the SELECT statement</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_create">--create</a></td>
<td>File or string containing the statement to use for creating the table</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_create-schema">--create-schema</a></td>
<td>Schema in which to run the tests</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_csv">--csv</a></td>
<td>Generate output in comma-separated values format</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_debug">--debug</a></td>
<td>Write debugging log</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_debug-check">--debug-check</a></td>
<td>Print debugging information when program exits</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_debug-info">--debug-info</a></td>
<td>Print debugging information, memory, and CPU statistics when program exits</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_default-auth">--default-auth</a></td>
<td>Authentication plugin to use</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_defaults-extra-file">--defaults-extra-file</a></td>
<td>Read named option file in addition to usual option files</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_defaults-file">--defaults-file</a></td>
<td>Read only named option file</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_defaults-group-suffix">--defaults-group-suffix</a></td>
<td>Option group suffix value</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_delimiter">--delimiter</a></td>
<td>Delimiter to use in SQL statements</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_detach">--detach</a></td>
<td>Detach (close and reopen) each connection after each N statements</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_enable-cleartext-plugin">--enable-cleartext-plugin</a></td>
<td>Enable cleartext authentication plugin</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_engine">--engine</a></td>
<td>Storage engine to use for creating the table</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_get-server-public-key">--get-server-public-key</a></td>
<td>Request RSA public key from server</td>
<td>8.0.3</td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_help">--help</a></td>
<td>Display help message and exit</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_host">--host</a></td>
<td>Connect to MySQL server on given host</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_iterations">--iterations</a></td>
<td>Number of times to run the tests</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_login-path">--login-path</a></td>
<td>Read login path options from .mylogin.cnf</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_no-defaults">--no-defaults</a></td>
<td>Read no option files</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_no-drop">--no-drop</a></td>
<td>Do not drop any schema created during the test run</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_number-char-cols">--number-char-cols</a></td>
<td>Number of VARCHAR columns to use if --auto-generate-sql is specified</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_number-int-cols">--number-int-cols</a></td>
<td>Number of INT columns to use if --auto-generate-sql is specified</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_number-of-queries">--number-of-queries</a></td>
<td>Limit each client to approximately this number of queries</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_only-print">--only-print</a></td>
<td>Do not connect to databases. mysqlslap only prints what it would have done</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_password">--password</a></td>
<td>Password to use when connecting to server</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_pipe">--pipe</a></td>
<td>Connect to server using named pipe (Windows only)</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_plugin-dir">--plugin-dir</a></td>
<td>Directory where plugins are installed</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_port">--port</a></td>
<td>TCP/IP port number for connection</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_post-query">--post-query</a></td>
<td>File or string containing the statement to execute after the tests have completed</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_post-system">--post-system</a></td>
<td>String to execute using system() after the tests have completed</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_pre-query">--pre-query</a></td>
<td>File or string containing the statement to execute before running the tests</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_pre-system">--pre-system</a></td>
<td>String to execute using system() before running the tests</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_print-defaults">--print-defaults</a></td>
<td>Print default options</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_protocol">--protocol</a></td>
<td>Connection protocol to use</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_query">--query</a></td>
<td>File or string containing the SELECT statement to use for retrieving data</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_secure-auth">--secure-auth</a></td>
<td>Do not send passwords to server in old (pre-4.1) format</td>
<td></td>
<td>8.0.3</td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_server-public-key-path">--server-public-key-path</a></td>
<td>Path name to file containing RSA public key</td>
<td>8.0.4</td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_shared-memory-base-name">--shared-memory-base-name</a></td>
<td>Name of shared memory to use for shared-memory connections</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_silent">--silent</a></td>
<td>Silent mode</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_socket">--socket</a></td>
<td>The Unix socket file or Windows named pipe to use</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_sql-mode">--sql-mode</a></td>
<td>Set SQL mode for client session</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-ca</a></td>
<td>File that contains list of trusted SSL Certificate Authorities</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-capath</a></td>
<td>Directory that contains trusted SSL Certificate Authority certificate files</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-cert</a></td>
<td>File that contains X.509 certificate</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-cipher</a></td>
<td>Permissible ciphers for connection encryption</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-crl</a></td>
<td>File that contains certificate revocation lists</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-crlpath</a></td>
<td>Directory that contains certificate revocation-list files</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl-fips-mode">--ssl-fips-mode</a></td>
<td>Whether to enable FIPS mode on client side</td>
<td>8.0.11</td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-key</a></td>
<td>File that contains X.509 key</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_ssl">--ssl-mode</a></td>
<td>Desired security state of connection to server</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_tls-ciphersuites">--tls-ciphersuites</a></td>
<td>Permissible TLSv1.3 ciphersuites for encrypted connections</td>
<td>8.0.16</td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_tls-version">--tls-version</a></td>
<td>Permissible TLS protocols for encrypted connections</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_user">--user</a></td>
<td>MySQL user name to use when connecting to server</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_verbose">--verbose</a></td>
<td>Verbose mode</td>
<td></td>
<td></td>
</tr><tr><td scope="row"><a class="link" href="mysqlslap.html#option_mysqlslap_version">--version</a></td>
<td>Display version information and exit</td>
<td></td>
<td></td>
</tr></tbody></table>
</div>

</div>
<br class="table-break">
<div class="itemizedlist">
<ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><a name="option_mysqlslap_help"></a>
            <a class="indexterm" name="idm139663282012064"></a>

            <a class="indexterm" name="idm139663282010608"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_help"><code class="option">--help</code></a>,
            <code class="option">-?</code>
          </p><p>
            Display a help message and exit.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql"></a>
            <a class="indexterm" name="idm139663282006096"></a>

            <a class="indexterm" name="idm139663282004640"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql"><code class="option">--auto-generate-sql</code></a>,
            <code class="option">-a</code>
          </p><p>
            Generate SQL statements automatically when they are not
            supplied in files or using command options.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-add-autoincrement"></a>
            <a class="indexterm" name="idm139663281999856"></a>

            <a class="indexterm" name="idm139663281998400"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-add-autoincrement"><code class="option">--auto-generate-sql-add-autoincrement</code></a>
          </p><p>
            Add an <code class="literal">AUTO_INCREMENT</code> column to
            automatically generated tables.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-execute-number"></a>
            <a class="indexterm" name="idm139663281993472"></a>

            <a class="indexterm" name="idm139663281991968"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-execute-number"><code class="option">--auto-generate-sql-execute-number=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            Specify how many queries to generate automatically.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-guid-primary"></a>
            <a class="indexterm" name="idm139663281987520"></a>

            <a class="indexterm" name="idm139663281986016"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-guid-primary"><code class="option">--auto-generate-sql-guid-primary</code></a>
          </p><p>
            Add a GUID-based primary key to automatically generated
            tables.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-load-type"></a>
            <a class="indexterm" name="idm139663281981808"></a>

            <a class="indexterm" name="idm139663281980304"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-load-type"><code class="option">--auto-generate-sql-load-type=<em class="replaceable"><code>type</code></em></code></a>
          </p><p>
            Specify the test load type. The permissible values are
            <code class="literal">read</code> (scan tables),
            <code class="literal">write</code> (insert into tables),
            <code class="literal">key</code> (read primary keys),
            <code class="literal">update</code> (update primary keys), or
            <code class="literal">mixed</code> (half inserts, half scanning
            selects). The default is <code class="literal">mixed</code>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-secondary-indexes"></a>
            <a class="indexterm" name="idm139663281971360"></a>

            <a class="indexterm" name="idm139663281969904"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-secondary-indexes"><code class="option">--auto-generate-sql-secondary-indexes=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            Specify how many secondary indexes to add to automatically
            generated tables. By default, none are added.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-unique-query-number"></a>
            <a class="indexterm" name="idm139663281965312"></a>

            <a class="indexterm" name="idm139663281963856"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-unique-query-number"><code class="option">--auto-generate-sql-unique-query-number=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            How many different queries to generate for automatic tests.
            For example, if you run a <code class="literal">key</code> test that
            performs 1000 selects, you can use this option with a value
            of 1000 to run 1000 unique queries, or with a value of 50 to
            perform 50 different selects. The default is 10.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-unique-write-number"></a>
            <a class="indexterm" name="idm139663281958384"></a>

            <a class="indexterm" name="idm139663281956928"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-unique-write-number"><code class="option">--auto-generate-sql-unique-write-number=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            How many different queries to generate for
            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-write-number"><code class="option">--auto-generate-sql-write-number</code></a>.
            The default is 10.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_auto-generate-sql-write-number"></a>
            <a class="indexterm" name="idm139663281951328"></a>

            <a class="indexterm" name="idm139663281949888"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql-write-number"><code class="option">--auto-generate-sql-write-number=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            How many row inserts to perform. The default is 100.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_commit"></a>
            <a class="indexterm" name="idm139663281945472"></a>

            <a class="indexterm" name="idm139663281944016"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_commit"><code class="option">--commit=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            How many statements to execute before committing. The
            default is 0 (no commits are done).
          </p></li><li class="listitem"><p><a name="option_mysqlslap_compress"></a>
            <a class="indexterm" name="idm139663281939536"></a>

            <a class="indexterm" name="idm139663281938048"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_compress"><code class="option">--compress</code></a>,
            <code class="option">-C</code>
          </p><p>
            Compress all information sent between the client and the
            server if possible. See
            <a class="xref" href="connection-compression-control.html" title="4.2.6 Connection Compression Control">Section 4.2.6, “Connection Compression Control”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_concurrency"></a>
            <a class="indexterm" name="idm139663281932736"></a>

            <a class="indexterm" name="idm139663281931248"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_concurrency"><code class="option">--concurrency=<em class="replaceable"><code>N</code></em></code></a>,
            <code class="option">-c <em class="replaceable"><code>N</code></em></code>
          </p><p>
            The number of parallel clients to simulate.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_create"></a>
            <a class="indexterm" name="idm139663281926176"></a>

            <a class="indexterm" name="idm139663281924720"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_create"><code class="option">--create=<em class="replaceable"><code>value</code></em></code></a>
          </p><p>
            The file or string containing the statement to use for
            creating the table.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_create-schema"></a>
            <a class="indexterm" name="idm139663281920336"></a>

            <a class="indexterm" name="idm139663281918848"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_create-schema"><code class="option">--create-schema=<em class="replaceable"><code>value</code></em></code></a>
          </p><p>
            The schema in which to run the tests.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">

<div class="admon-title">
Note
</div>
<p>
              If the
              <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql"><code class="option">--auto-generate-sql</code></a>
              option is also given, <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> drops
              the schema at the end of the test run. To avoid this, use
              the <a class="link" href="mysqlslap.html#option_mysqlslap_no-drop"><code class="option">--no-drop</code></a> option as
              well.
</p>
</div>
</li><li class="listitem"><p><a name="option_mysqlslap_csv"></a>
            <a class="indexterm" name="idm139663281910256"></a>

            <a class="indexterm" name="idm139663281908800"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_csv"><code class="option">--csv[=<em class="replaceable"><code>file_name</code></em>]</code></a>
          </p><p>
            Generate output in comma-separated values format. The output
            goes to the named file, or to the standard output if no file
            is given.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_debug"></a>
            <a class="indexterm" name="idm139663281904208"></a>

            <a class="indexterm" name="idm139663281902752"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_debug"><code class="option">--debug[=<em class="replaceable"><code>debug_options</code></em>]</code></a>,
            <code class="option">-#
            [<em class="replaceable"><code>debug_options</code></em>]</code>
          </p><p>
            Write a debugging log. A typical
            <em class="replaceable"><code>debug_options</code></em> string is
            <code class="literal">d:t:o,<em class="replaceable"><code>file_name</code></em></code>.
            The default is
            <code class="literal">d:t:o,/tmp/mysqlslap.trace</code>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_debug-check"></a>
            <a class="indexterm" name="idm139663281895088"></a>

            <a class="indexterm" name="idm139663281893600"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_debug-check"><code class="option">--debug-check</code></a>
          </p><p>
            Print some debugging information when the program exits.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_debug-info"></a>
            <a class="indexterm" name="idm139663281889504"></a>

            <a class="indexterm" name="idm139663281888016"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_debug-info"><code class="option">--debug-info</code></a>,
            <code class="option">-T</code>
          </p><p>
            Print debugging information and memory and CPU usage
            statistics when the program exits.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_default-auth"></a>
            <a class="indexterm" name="idm139663281883392"></a>

            <a class="indexterm" name="idm139663281881904"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_default-auth"><code class="option">--default-auth=<em class="replaceable"><code>plugin</code></em></code></a>
          </p><p>
            A hint about which client-side authentication plugin to use.
            See <a class="xref" href="pluggable-authentication.html" title="6.2.17 Pluggable Authentication">Section 6.2.17, “Pluggable Authentication”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_defaults-extra-file"></a>
            <a class="indexterm" name="idm139663281876800"></a>

            <a class="indexterm" name="idm139663281875344"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_defaults-extra-file"><code class="option">--defaults-extra-file=<em class="replaceable"><code>file_name</code></em></code></a>
          </p><p>
            Read this option file after the global option file but (on
            Unix) before the user option file. If the file does not
            exist or is otherwise inaccessible, an error occurs.
            <em class="replaceable"><code>file_name</code></em> is interpreted relative
            to the current directory if given as a relative path name
            rather than a full path name.
          </p><p>
            For additional information about this and other option-file
            options, see <a class="xref" href="option-file-options.html" title="4.2.2.3 Command-Line Options that Affect Option-File Handling">Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_defaults-file"></a>
            <a class="indexterm" name="idm139663281868944"></a>

            <a class="indexterm" name="idm139663281867456"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_defaults-file"><code class="option">--defaults-file=<em class="replaceable"><code>file_name</code></em></code></a>
          </p><p>
            Use only the given option file. If the file does not exist
            or is otherwise inaccessible, an error occurs.
            <em class="replaceable"><code>file_name</code></em> is interpreted relative
            to the current directory if given as a relative path name
            rather than a full path name.
          </p><p>
            Exception: Even with
            <a class="link" href="option-file-options.html#option_general_defaults-file"><code class="option">--defaults-file</code></a>, client
            programs read <code class="filename">.mylogin.cnf</code>.
          </p><p>
            For additional information about this and other option-file
            options, see <a class="xref" href="option-file-options.html" title="4.2.2.3 Command-Line Options that Affect Option-File Handling">Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_defaults-group-suffix"></a>
            <a class="indexterm" name="idm139663281859088"></a>

            <a class="indexterm" name="idm139663281857632"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_defaults-group-suffix"><code class="option">--defaults-group-suffix=<em class="replaceable"><code>str</code></em></code></a>
          </p><p>
            Read not only the usual option groups, but also groups with
            the usual names and a suffix of
            <em class="replaceable"><code>str</code></em>. For example,
            <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> normally reads the
            <code class="literal">[client]</code> and
            <code class="literal">[mysqlslap]</code> groups. If the
            <a class="link" href="mysqlslap.html#option_mysqlslap_defaults-group-suffix"><code class="option">--defaults-group-suffix=_other</code></a>
            option is given, <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> also reads the
            <code class="literal">[client_other]</code> and
            <code class="literal">[mysqlslap_other]</code> groups.
          </p><p>
            For additional information about this and other option-file
            options, see <a class="xref" href="option-file-options.html" title="4.2.2.3 Command-Line Options that Affect Option-File Handling">Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_delimiter"></a>
            <a class="indexterm" name="idm139663281845072"></a>

            <a class="indexterm" name="idm139663281843584"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_delimiter"><code class="option">--delimiter=<em class="replaceable"><code>str</code></em></code></a>,
            <code class="option">-F <em class="replaceable"><code>str</code></em></code>
          </p><p>
            The delimiter to use in SQL statements supplied in files or
            using command options.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_detach"></a>
            <a class="indexterm" name="idm139663281838528"></a>

            <a class="indexterm" name="idm139663281837072"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_detach"><code class="option">--detach=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            Detach (close and reopen) each connection after each
            <em class="replaceable"><code>N</code></em> statements. The default is 0
            (connections are not detached).
          </p></li><li class="listitem"><p><a name="option_mysqlslap_enable-cleartext-plugin"></a>
            <a class="indexterm" name="idm139663281832224"></a>

            <a class="indexterm" name="idm139663281830720"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_enable-cleartext-plugin"><code class="option">--enable-cleartext-plugin</code></a>
          </p><p>
            Enable the <code class="literal">mysql_clear_password</code> cleartext
            authentication plugin. (See
            <a class="xref" href="cleartext-pluggable-authentication.html" title="6.4.1.4 Client-Side Cleartext Pluggable Authentication">Section 6.4.1.4, “Client-Side Cleartext Pluggable Authentication”</a>.)
          </p></li><li class="listitem"><p><a name="option_mysqlslap_engine"></a>
            <a class="indexterm" name="idm139663281825088"></a>

            <a class="indexterm" name="idm139663281823632"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_engine"><code class="option">--engine=<em class="replaceable"><code>engine_name</code></em></code></a>,
            <code class="option">-e <em class="replaceable"><code>engine_name</code></em></code>
          </p><p>
            The storage engine to use for creating tables.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_get-server-public-key"></a>
            <a class="indexterm" name="idm139663281818592"></a>

            <a class="indexterm" name="idm139663281817136"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_get-server-public-key"><code class="option">--get-server-public-key</code></a>
          </p><p>
            Request from the server the RSA public key that it uses for
            key pair-based password exchange. This option applies to
            clients that connect to the server using an account that
            authenticates with the
            <code class="literal">caching_sha2_password</code> authentication
            plugin. For connections by such accounts, the server does
            not send the public key to the client unless requested. The
            option is ignored for accounts that do not authenticate with
            that plugin. It is also ignored if RSA-based password
            exchange is not needed, as is the case when the client
            connects to the server using a secure connection.
          </p><p>
            If
            <a class="link" href="mysqlslap.html#option_mysqlslap_server-public-key-path"><code class="option">--server-public-key-path=<em class="replaceable"><code>file_name</code></em></code></a>
            is given and specifies a valid public key file, it takes
            precedence over
            <a class="link" href="mysqlslap.html#option_mysqlslap_get-server-public-key"><code class="option">--get-server-public-key</code></a>.
          </p><p>
            For information about the
            <code class="literal">caching_sha2_password</code> plugin, see
            <a class="xref" href="caching-sha2-pluggable-authentication.html" title="6.4.1.3 Caching SHA-2 Pluggable Authentication">Section 6.4.1.3, “Caching SHA-2 Pluggable Authentication”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_host"></a>
            <a class="indexterm" name="idm139663281806960"></a>

            <a class="indexterm" name="idm139663281805504"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_host"><code class="option">--host=<em class="replaceable"><code>host_name</code></em></code></a>,
            <code class="option">-h <em class="replaceable"><code>host_name</code></em></code>
          </p><p>
            Connect to the MySQL server on the given host.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_iterations"></a>
            <a class="indexterm" name="idm139663281800464"></a>

            <a class="indexterm" name="idm139663281798976"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_iterations"><code class="option">--iterations=<em class="replaceable"><code>N</code></em></code></a>,
            <code class="option">-i <em class="replaceable"><code>N</code></em></code>
          </p><p>
            The number of times to run the tests.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_login-path"></a>
            <a class="indexterm" name="idm139663281793968"></a>

            <a class="indexterm" name="idm139663281792480"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_login-path"><code class="option">--login-path=<em class="replaceable"><code>name</code></em></code></a>
          </p><p>
            Read options from the named login path in the
            <code class="filename">.mylogin.cnf</code> login path file. A
            <span class="quote">“<span class="quote">login path</span>”</span> is an option group containing
            options that specify which MySQL server to connect to and
            which account to authenticate as. To create or modify a
            login path file, use the
            <a class="link" href="mysql-config-editor.html" title="4.6.7 mysql_config_editor — MySQL Configuration Utility"><span class="command"><strong>mysql_config_editor</strong></span></a> utility. See
            <a class="xref" href="mysql-config-editor.html" title="4.6.7 mysql_config_editor — MySQL Configuration Utility">Section 4.6.7, “<span class="command"><strong>mysql_config_editor</strong></span> — MySQL Configuration Utility”</a>.
          </p><p>
            For additional information about this and other option-file
            options, see <a class="xref" href="option-file-options.html" title="4.2.2.3 Command-Line Options that Affect Option-File Handling">Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_no-drop"></a>
            <a class="indexterm" name="idm139663281783632"></a>

            <a class="indexterm" name="idm139663281782144"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_no-drop"><code class="option">--no-drop</code></a>
          </p><p>
            Prevent <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> from dropping any
            schema it creates during the test run.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_no-defaults"></a>
            <a class="indexterm" name="idm139663281776816"></a>

            <a class="indexterm" name="idm139663281775328"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_no-defaults"><code class="option">--no-defaults</code></a>
          </p><p>
            Do not read any option files. If program startup fails due
            to reading unknown options from an option file,
            <a class="link" href="mysqlslap.html#option_mysqlslap_no-defaults"><code class="option">--no-defaults</code></a> can be used
            to prevent them from being read.
          </p><p>
            The exception is that the <code class="filename">.mylogin.cnf</code>
            file, if it exists, is read in all cases. This permits
            passwords to be specified in a safer way than on the command
            line even when
            <a class="link" href="mysqlslap.html#option_mysqlslap_no-defaults"><code class="option">--no-defaults</code></a> is used.
            (<code class="filename">.mylogin.cnf</code> is created by the
            <a class="link" href="mysql-config-editor.html" title="4.6.7 mysql_config_editor — MySQL Configuration Utility"><span class="command"><strong>mysql_config_editor</strong></span></a> utility. See
            <a class="xref" href="mysql-config-editor.html" title="4.6.7 mysql_config_editor — MySQL Configuration Utility">Section 4.6.7, “<span class="command"><strong>mysql_config_editor</strong></span> — MySQL Configuration Utility”</a>.)
          </p><p>
            For additional information about this and other option-file
            options, see <a class="xref" href="option-file-options.html" title="4.2.2.3 Command-Line Options that Affect Option-File Handling">Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_number-char-cols"></a>
            <a class="indexterm" name="idm139663281763936"></a>

            <a class="indexterm" name="idm139663281762448"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_number-char-cols"><code class="option">--number-char-cols=<em class="replaceable"><code>N</code></em></code></a>,
            <code class="option">-x <em class="replaceable"><code>N</code></em></code>
          </p><p>
            The number of <a class="link" href="char.html" title="11.4.1 The CHAR and VARCHAR Types"><code class="literal">VARCHAR</code></a> columns
            to use if
            <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql"><code class="option">--auto-generate-sql</code></a> is
            specified.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_number-int-cols"></a>
            <a class="indexterm" name="idm139663281755200"></a>

            <a class="indexterm" name="idm139663281753712"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_number-int-cols"><code class="option">--number-int-cols=<em class="replaceable"><code>N</code></em></code></a>,
            <code class="option">-y <em class="replaceable"><code>N</code></em></code>
          </p><p>
            The number of <a class="link" href="integer-types.html" title="11.2.1 Integer Types (Exact Value) - INTEGER, INT, SMALLINT, TINYINT, MEDIUMINT, BIGINT"><code class="literal">INT</code></a> columns to
            use if <a class="link" href="mysqlslap.html#option_mysqlslap_auto-generate-sql"><code class="option">--auto-generate-sql</code></a>
            is specified.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_number-of-queries"></a>
            <a class="indexterm" name="idm139663281746400"></a>

            <a class="indexterm" name="idm139663281744944"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_number-of-queries"><code class="option">--number-of-queries=<em class="replaceable"><code>N</code></em></code></a>
          </p><p>
            Limit each client to approximately this many queries. Query
            counting takes into account the statement delimiter. For
            example, if you invoke <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> as
            follows, the <code class="literal">;</code> delimiter is recognized so
            that each instance of the query string counts as two
            queries. As a result, 5 rows (not 10) are inserted.
          </p><pre class="programlisting copytoclipboard line-numbers language-terminal"><code class="language-terminal">shell&gt; mysqlslap --delimiter=";" --number-of-queries=10
         --query="use test;insert into t values(null)"</code></pre></li><li class="listitem"><p><a name="option_mysqlslap_only-print"></a>
            <a class="indexterm" name="idm139663281735952"></a>

            <a class="indexterm" name="idm139663281734464"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_only-print"><code class="option">--only-print</code></a>
          </p><p>
            Do not connect to databases. <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a>
            only prints what it would have done.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_password"></a>
            <a class="indexterm" name="idm139663281729120"></a>

            <a class="indexterm" name="idm139663281727632"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_password"><code class="option">--password[=<em class="replaceable"><code>password</code></em>]</code></a>,
            <code class="option">-p[<em class="replaceable"><code>password</code></em>]</code>
          </p><p>
            The password of the MySQL account used for connecting to the
            server. The password value is optional. If not given,
            <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> prompts for one. If given,
            there must be <span class="emphasis"><em>no space</em></span> between
            <a class="link" href="mysqlslap.html#option_mysqlslap_password"><code class="option">--password=</code></a> or
            <code class="option">-p</code> and the password following it. If no
            password option is specified, the default is to send no
            password.
          </p><p>
            Specifying a password on the command line should be
            considered insecure. To avoid giving the password on the
            command line, use an option file. See
            <a class="xref" href="password-security-user.html" title="6.1.2.1 End-User Guidelines for Password Security">Section 6.1.2.1, “End-User Guidelines for Password Security”</a>.
          </p><p>
            To explicitly specify that there is no password and that
            <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> should not prompt for one, use
            the
            <a class="link" href="mysqlslap.html#option_mysqlslap_password"><code class="option">--skip-password</code></a>
            option.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_pipe"></a>
            <a class="indexterm" name="idm139663281714976"></a>

            <a class="indexterm" name="idm139663281713520"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_pipe"><code class="option">--pipe</code></a>,
            <code class="option">-W</code>
          </p><p>
            On Windows, connect to the server using a named pipe. This
            option applies only if the server was started with the
            <a class="link" href="server-system-variables.html#sysvar_named_pipe"><code class="literal">named_pipe</code></a> system variable
            enabled to support named-pipe connections. In addition, the
            user making the connection must be a member of the Windows
            group specified by the
            <a class="link" href="server-system-variables.html#sysvar_named_pipe_full_access_group"><code class="literal">named_pipe_full_access_group</code></a>
            system variable.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_plugin-dir"></a>
            <a class="indexterm" name="idm139663281706128"></a>

            <a class="indexterm" name="idm139663281704640"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_plugin-dir"><code class="option">--plugin-dir=<em class="replaceable"><code>dir_name</code></em></code></a>
          </p><p>
            The directory in which to look for plugins. Specify this
            option if the
            <a class="link" href="mysqlslap.html#option_mysqlslap_default-auth"><code class="option">--default-auth</code></a> option is
            used to specify an authentication plugin but
            <a class="link" href="mysqlslap.html" title="4.5.8 mysqlslap — Load Emulation Client"><span class="command"><strong>mysqlslap</strong></span></a> does not find it. See
            <a class="xref" href="pluggable-authentication.html" title="6.2.17 Pluggable Authentication">Section 6.2.17, “Pluggable Authentication”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_port"></a>
            <a class="indexterm" name="idm139663281697216"></a>

            <a class="indexterm" name="idm139663281695760"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_port"><code class="option">--port=<em class="replaceable"><code>port_num</code></em></code></a>,
            <code class="option">-P <em class="replaceable"><code>port_num</code></em></code>
          </p><p>
            For TCP/IP connections, the port number to use.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_post-query"></a>
            <a class="indexterm" name="idm139663281690720"></a>

            <a class="indexterm" name="idm139663281689232"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_post-query"><code class="option">--post-query=<em class="replaceable"><code>value</code></em></code></a>
          </p><p>
            The file or string containing the statement to execute after
            the tests have completed. This execution is not counted for
            timing purposes.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_post-system"></a>
            <a class="indexterm" name="idm139663281684672"></a>

            <a class="indexterm" name="idm139663281683184"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_post-system"><code class="option">--post-system=<em class="replaceable"><code>str</code></em></code></a>
          </p><p>
            The string to execute using <code class="literal">system()</code>
            after the tests have completed. This execution is not
            counted for timing purposes.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_pre-query"></a>
            <a class="indexterm" name="idm139663281678032"></a>

            <a class="indexterm" name="idm139663281676544"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_pre-query"><code class="option">--pre-query=<em class="replaceable"><code>value</code></em></code></a>
          </p><p>
            The file or string containing the statement to execute
            before running the tests. This execution is not counted for
            timing purposes.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_pre-system"></a>
            <a class="indexterm" name="idm139663281672000"></a>

            <a class="indexterm" name="idm139663281670512"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_pre-system"><code class="option">--pre-system=<em class="replaceable"><code>str</code></em></code></a>
          </p><p>
            The string to execute using <code class="literal">system()</code>
            before running the tests. This execution is not counted for
            timing purposes.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_print-defaults"></a>
            <a class="indexterm" name="idm139663281665376"></a>

            <a class="indexterm" name="idm139663281663888"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_print-defaults"><code class="option">--print-defaults</code></a>
          </p><p>
            Print the program name and all options that it gets from
            option files.
          </p><p>
            For additional information about this and other option-file
            options, see <a class="xref" href="option-file-options.html" title="4.2.2.3 Command-Line Options that Affect Option-File Handling">Section 4.2.2.3, “Command-Line Options that Affect Option-File Handling”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_protocol"></a>
            <a class="indexterm" name="idm139663281658592"></a>

            <a class="indexterm" name="idm139663281657104"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_protocol"><code class="option">--protocol={TCP|SOCKET|PIPE|MEMORY}</code></a>
          </p><p>
            The connection protocol to use for connecting to the server.
            It is useful when the other connection parameters normally
            result in use of a protocol other than the one you want. For
            details on the permissible values, see
            <a class="xref" href="connecting.html" title="4.2.4 Connecting to the MySQL Server Using Command Options">Section 4.2.4, “Connecting to the MySQL Server Using Command Options”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_query"></a>
            <a class="indexterm" name="idm139663281652096"></a>

            <a class="indexterm" name="idm139663281650640"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_query"><code class="option">--query=<em class="replaceable"><code>value</code></em></code></a>,
            <code class="option">-q <em class="replaceable"><code>value</code></em></code>
          </p><p>
            The file or string containing the
            <a class="link" href="select.html" title="13.2.10 SELECT Syntax"><code class="literal">SELECT</code></a> statement to use for
            retrieving data.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_secure-auth"></a>
            <a class="indexterm" name="idm139663281644224"></a>

            <a class="indexterm" name="idm139663281642736"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_secure-auth"><code class="option">--secure-auth</code></a>
          </p><p>
            This option was removed in MySQL 8.0.3.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_server-public-key-path"></a>
            <a class="indexterm" name="idm139663281638592"></a>

            <a class="indexterm" name="idm139663281637136"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_server-public-key-path"><code class="option">--server-public-key-path=<em class="replaceable"><code>file_name</code></em></code></a>
          </p><p>
            The path name to a file containing a client-side copy of the
            public key required by the server for RSA key pair-based
            password exchange. The file must be in PEM format. This
            option applies to clients that authenticate with the
            <code class="literal">sha256_password</code> or
            <code class="literal">caching_sha2_password</code> authentication
            plugin. This option is ignored for accounts that do not
            authenticate with one of those plugins. It is also ignored
            if RSA-based password exchange is not used, as is the case
            when the client connects to the server using a secure
            connection.
          </p><p>
            If
            <a class="link" href="mysqlslap.html#option_mysqlslap_server-public-key-path"><code class="option">--server-public-key-path=<em class="replaceable"><code>file_name</code></em></code></a>
            is given and specifies a valid public key file, it takes
            precedence over
            <a class="link" href="mysqlslap.html#option_mysqlslap_get-server-public-key"><code class="option">--get-server-public-key</code></a>.
          </p><p>
            For <code class="literal">sha256_password</code>, this option applies
            only if MySQL was built using OpenSSL.
          </p><p>
            For information about the <code class="literal">sha256_password</code>
            and <code class="literal">caching_sha2_password</code> plugins, see
            <a class="xref" href="sha256-pluggable-authentication.html" title="6.4.1.2 SHA-256 Pluggable Authentication">Section 6.4.1.2, “SHA-256 Pluggable Authentication”</a>, and
            <a class="xref" href="caching-sha2-pluggable-authentication.html" title="6.4.1.3 Caching SHA-2 Pluggable Authentication">Section 6.4.1.3, “Caching SHA-2 Pluggable Authentication”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_shared-memory-base-name"></a>
            <a class="indexterm" name="idm139663281623312"></a>

            <a class="indexterm" name="idm139663281621856"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_shared-memory-base-name"><code class="option">--shared-memory-base-name=<em class="replaceable"><code>name</code></em></code></a>
          </p><p>
            On Windows, the shared-memory name to use, for connections
            made using shared memory to a local server. The default
            value is <code class="literal">MYSQL</code>. The shared-memory name is
            case-sensitive.
          </p><p>
            This option applies only if the server was started with the
            <a class="link" href="server-system-variables.html#sysvar_shared_memory"><code class="literal">shared_memory</code></a> system
            variable enabled to support shared-memory connections.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_silent"></a>
            <a class="indexterm" name="idm139663281614784"></a>

            <a class="indexterm" name="idm139663281613328"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_silent"><code class="option">--silent</code></a>,
            <code class="option">-s</code>
          </p><p>
            Silent mode. No output.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_socket"></a>
            <a class="indexterm" name="idm139663281608816"></a>

            <a class="indexterm" name="idm139663281607360"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_socket"><code class="option">--socket=<em class="replaceable"><code>path</code></em></code></a>,
            <code class="option">-S <em class="replaceable"><code>path</code></em></code>
          </p><p>
            For connections to <code class="literal">localhost</code>, the Unix
            socket file to use, or, on Windows, the name of the named
            pipe to use.
          </p><p>
            On Windows, this option applies only if the server was
            started with the <a class="link" href="server-system-variables.html#sysvar_named_pipe"><code class="literal">named_pipe</code></a>
            system variable enabled to support named-pipe connections.
            In addition, the user making the connection must be a member
            of the Windows group specified by the
            <a class="link" href="server-system-variables.html#sysvar_named_pipe_full_access_group"><code class="literal">named_pipe_full_access_group</code></a>
            system variable.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_sql-mode"></a>
            <a class="indexterm" name="idm139663281598192"></a>

            <a class="indexterm" name="idm139663281596704"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_sql-mode"><code class="option">--sql-mode=<em class="replaceable"><code>mode</code></em></code></a>
          </p><p>
            Set the SQL mode for the client session.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_ssl"></a>
            <a class="indexterm" name="idm139663281592336"></a>

            <a class="indexterm" name="idm139663281590880"></a>

            <code class="option">--ssl*</code>
          </p><p>
            Options that begin with
            <a class="link" href="connection-options.html#option_general_ssl"><code class="option">--ssl</code></a> specify whether to
            connect to the server using SSL and indicate where to find
            SSL keys and certificates. See
            <a class="xref" href="connection-options.html#encrypted-connection-options" title="Command Options for Encrypted Connections">Command Options for Encrypted Connections</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_ssl-fips-mode"></a>
            <a class="link" href="mysqlslap.html#option_mysqlslap_ssl-fips-mode"><code class="option">--ssl-fips-mode={OFF|ON|STRICT}</code></a>
          </p><a class="indexterm" name="idm139663281584448"></a><p>
            Controls whether to enable FIPS mode on the client side. The
            <a class="link" href="mysqlslap.html#option_mysqlslap_ssl-fips-mode"><code class="option">--ssl-fips-mode</code></a> option
            differs from other
            <code class="option">--ssl-<em class="replaceable"><code>xxx</code></em></code>
            options in that it is not used to establish encrypted
            connections, but rather to affect which cryptographic
            operations are permitted. See <a class="xref" href="fips-mode.html" title="6.5 FIPS Support">Section 6.5, “FIPS Support”</a>.
          </p><p>
            These <a class="link" href="mysqlslap.html#option_mysqlslap_ssl-fips-mode"><code class="option">--ssl-fips-mode</code></a>
            values are permitted:
</p>
<div class="itemizedlist">
<ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>
                <code class="literal">OFF</code>: Disable FIPS mode.
              </p></li><li class="listitem"><p>
                <code class="literal">ON</code>: Enable FIPS mode.
              </p></li><li class="listitem"><p>
                <code class="literal">STRICT</code>: Enable <span class="quote">“<span class="quote">strict</span>”</span>
                FIPS mode.
</p></li></ul>
</div>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<div class="admon-title">
Note
</div>
<p>
              If the OpenSSL FIPS Object Module is not available, the
              only permitted value for
              <a class="link" href="mysqlslap.html#option_mysqlslap_ssl-fips-mode"><code class="option">--ssl-fips-mode</code></a> is
              <code class="literal">OFF</code>. In this case, setting
              <a class="link" href="mysqlslap.html#option_mysqlslap_ssl-fips-mode"><code class="option">--ssl-fips-mode</code></a> to
              <code class="literal">ON</code> or <code class="literal">STRICT</code> causes
              the client to produce a warning at startup and to operate
              in non-FIPS mode.
</p>
</div>
</li><li class="listitem"><p><a name="option_mysqlslap_tls-ciphersuites"></a>
            <a class="indexterm" name="idm139663281567328"></a>

            <a class="indexterm" name="idm139663281565840"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_tls-ciphersuites"><code class="option">--tls-ciphersuites=<em class="replaceable"><code>ciphersuite_list</code></em></code></a>
          </p><p>
            The permissible TLSv1.3 ciphersuites for encrypted
            connections. The value is a list of one or more
            colon-separated ciphersuite names. The ciphersuites that can
            be named for this option depend on the SSL library used to
            compile MySQL. For details, see
            <a class="xref" href="encrypted-connection-protocols-ciphers.html" title="6.3.5 Encrypted Connection Protocols and Ciphers">Section 6.3.5, “Encrypted Connection Protocols and Ciphers”</a>.
          </p><p>
            This option was added in MySQL 8.0.16.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_tls-version"></a>
            <a class="indexterm" name="idm139663281560048"></a>

            <a class="indexterm" name="idm139663281558560"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_tls-version"><code class="option">--tls-version=<em class="replaceable"><code>protocol_list</code></em></code></a>
          </p><p>
            The permissible TLS protocols for encrypted connections. The
            value is a list of one or more comma-separated protocol
            names. The protocols that can be named for this option
            depend on the SSL library used to compile MySQL. For
            details, see
            <a class="xref" href="encrypted-connection-protocols-ciphers.html" title="6.3.5 Encrypted Connection Protocols and Ciphers">Section 6.3.5, “Encrypted Connection Protocols and Ciphers”</a>.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_user"></a>
            <a class="indexterm" name="idm139663281553248"></a>

            <a class="indexterm" name="idm139663281551792"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_user"><code class="option">--user=<em class="replaceable"><code>user_name</code></em></code></a>,
            <code class="option">-u <em class="replaceable"><code>user_name</code></em></code>
          </p><p>
            The user name of the MySQL account to use for connecting to
            the server.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_verbose"></a>
            <a class="indexterm" name="idm139663281546640"></a>

            <a class="indexterm" name="idm139663281545184"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_verbose"><code class="option">--verbose</code></a>,
            <code class="option">-v</code>
          </p><p>
            Verbose mode. Print more information about what the program
            does. This option can be used multiple times to increase the
            amount of information.
          </p></li><li class="listitem"><p><a name="option_mysqlslap_version"></a>
            <a class="indexterm" name="idm139663281540512"></a>

            <a class="indexterm" name="idm139663281539024"></a>

            <a class="link" href="mysqlslap.html#option_mysqlslap_version"><code class="option">--version</code></a>,
            <code class="option">-V</code>
          </p><p>
            Display version information and exit.
</p></li></ul>
</div>

</div>

<br />
        </div>

                <div id="docs-in-page-nav-container">
            <div id="docs-in-page-nav">
                
    <a href="mysqlshow.html"
        aria-label="Previous" title="Previous: mysqlshow — Display Database, Table, and Column Information"><span
        class="icon-chevron-left"></span> PREV</a> &nbsp;
<a href="index.html" aria-label="Start" title="Start"> HOME</a> &nbsp;
        <a aria-label="Up" href="programs-client.html" title="Up: MySQL Client Programs"> UP</a> &nbsp;
    <a href="programs-admin-utils.html" aria-label="Next"
        title="Next: MySQL Administrative and Utility Programs">NEXT <span
        class="icon-chevron-right"></span></a>
            </div>
        </div>
        
         <div id="docs-body-extra">
             
<a class="docs-sidebar-section" href=""><span class="icon-related"></span>
    <span class="text">Related Documentation</span></a>
<div class="docs-sidebar-accordian">
    <div class="text">
        <a href="/doc/relnotes/mysql/8.0/en/">MySQL 8.0 Release Notes</a><br />
        <a href="/doc/dev/mysql-server/latest/">MySQL 8.0 Source Code Documentation</a><br />
        </div>
</div>

    <a class="docs-sidebar-section" href=""><span class="icon-download-thin"></span>
        <span class="text">
            Download
                            this Manual
                    </span>
    </a>
    <div class="docs-sidebar-accordian">
        <div class="text">
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.pdf">PDF (US Ltr)</a>
            - 46.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.a4.pdf">PDF (A4)</a>
            - 46.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-ref-manual-8.0-en-pdf-1-20190611.noarch.rpm">PDF (RPM)</a>
            - 41.5Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.html-chapter.tar.gz">HTML Download (TGZ)</a>
            - 10.6Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.html-chapter.zip">HTML Download (Zip)</a>
            - 10.6Mb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-ref-manual-8.0-en-html-chapter-1-20190611.noarch.rpm">HTML Download (RPM)</a>
            - 9.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.man-gpl.tar.gz">Man Pages (TGZ)</a>
            - 220.4Kb<br />
                        <a href="https://downloads.mysql.com/docs/refman-8.0-en.man-gpl.zip">Man Pages (Zip)</a>
            - 325.8Kb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-8.0.info.gz">Info (Gzip)</a>
            - 4.1Mb<br />
                        <a href="https://downloads.mysql.com/docs/mysql-8.0.info.zip">Info (Zip)</a>
            - 4.1Mb<br />
                    </div>
    </div>

<a class="docs-sidebar-section" href=""><span class="icon-book"></span>
    <span class="text">Excerpts from this Manual</span></a>
<div class="docs-sidebar-accordian">
    <div class="text">
                <a href="/doc/mysql-backup-excerpt/8.0/en/">MySQL Backup and Recovery</a><br />
                <a href="/doc/mysql-g11n-excerpt/8.0/en/">MySQL Globalization</a><br />
                <a href="/doc/mysql-infoschema-excerpt/8.0/en/">MySQL Information Schema</a><br />
                <a href="/doc/mysql-installation-excerpt/8.0/en/">MySQL Installation Guide</a><br />
                <a href="/doc/mysql-security-excerpt/8.0/en/">Security in MySQL</a><br />
                <a href="/doc/mysql-startstop-excerpt/8.0/en/">Starting and Stopping MySQL</a><br />
                <a href="/doc/mysql-linuxunix-excerpt/8.0/en/">MySQL and Linux/Unix</a><br />
                <a href="/doc/mysql-windows-excerpt/8.0/en/">MySQL and Windows</a><br />
                <a href="/doc/mysql-osx-excerpt/8.0/en/">MySQL and OS X</a><br />
                <a href="/doc/mysql-solaris-excerpt/8.0/en/">MySQL and Solaris</a><br />
                <a href="/doc/mysql-sourcebuild-excerpt/8.0/en/">Building MySQL from Source</a><br />
                <a href="/doc/mysql-reslimits-excerpt/8.0/en/">MySQL Restrictions and Limitations</a><br />
                <a href="/doc/mysql-partitioning-excerpt/8.0/en/">MySQL Partitioning</a><br />
                <a href="/doc/mysql-secure-deployment-guide/8.0/en/">MySQL Secure Deployment Guide</a><br />
                <a href="/doc/mysql-tutorial-excerpt/8.0/en/">MySQL Tutorial</a><br />
                <a href="/doc/mysql-perfschema-excerpt/8.0/en/">MySQL Performance Schema</a><br />
                <a href="/doc/mysql-replication-excerpt/8.0/en/">MySQL Replication</a><br />
                <a href="/doc/mysql-repo-excerpt/8.0/en/">Using the MySQL Yum Repository</a><br />
            </div>
</div>
         </div>

              </div>
     </div>

</div>

<script>
$(function() {
    var doc = new $.doc({ 'mobile': $.browser.mobile, 'docId': 1, 'highlight': true });
});
</script>
    

            
        </div>
    </div>

    <footer class="collapsed">
        <div id="footer-bottom">
                                    <div id="footer-collapse">
                <a href="" id="expand-footer"
                    aria-label="Expand Footer"
                    title="Expand Footer"><span
                    class="icon-plus-square"></span></a>
            </div>
                        <div class="footer-contact">
                <div id="footer-contact-icon" style="display: none;">
                    <span class="icon-call-phone"></span>
                </div>
                <div id="footer-contact-numbers" style="display: none;">
                    <strong>Contact MySQL Sales</strong><br/>
                    USA/Canada: +1-866-221-0634 &nbsp;
                    (<a href="https://www.mysql.com/about/contact/phone/">More Countries &raquo;</a>)
                </div>
                <div id="footer-contact-copyright" style="display: inline-block;">
                    <a href="http://www.oracle.com/" aria-label="Oracle" title="Oracle"><span class="oracle-logo"></span></a>
                    &nbsp; &copy; 2019, Oracle Corporation and/or its affiliates
                </div>
            </div>
            <div class="social-icons">
                <a aria-label="Join us on Facebook" title="Join us on Facebook" href="http://www.facebook.com/mysql"><span class="icon-facebook-square"></span></a>
                <a aria-label="Follow us on Twitter" title="Follow us on Twitter" href="https://twitter.com/mysql"><span class="icon-twitter-square"></span></a>
                <a aria-label="Follow us on LinkedIn" title="Follow us on LinkedIn" href="https://www.linkedin.com/company/mysql"><span class="icon-linkedin-square"></span></a>
                <a aria-label="Visit our YouTube channel" title="Visit our YouTube channel" href="http://www.youtube.com/mysqlchannel"><span class="icon-youtube-square"></span></a>
            </div>
            <br class="clear" />
        </div>
        <div id="footer-links">

            <div id="footer-nav"></div>

            <div class="links">
                <ul>
                    <li class="top"><a href="https://www.mysql.com/products/">Products</a></li>
                    <li><a href="https://www.mysql.com/cloud/">Oracle MySQL Cloud Service</a></li>
                    <li><a href="https://www.mysql.com/products/enterprise/">MySQL Enterprise Edition</a></li>
                    <li><a href="https://www.mysql.com/products/standard/">MySQL Standard Edition</a></li>
                    <li><a href="https://www.mysql.com/products/classic/">MySQL Classic Edition</a></li>
                    <li><a href="https://www.mysql.com/products/cluster/">MySQL Cluster CGE</a></li>
                    <li><a href="https://www.mysql.com/oem/">MySQL Embedded (OEM/ISV)</a></li>
                </ul>
            </div>

            <div class="links">
                <ul>
                    <li class="top"><a href="https://www.mysql.com/services/">Services</a></li>
                    <li><a href="https://www.mysql.com/training/">Training</a></li>
                    <li><a href="https://www.mysql.com/certification/">Certification</a></li>
                    <li><a href="https://www.mysql.com/consulting/">Consulting</a></li>
                    <li><a href="https://www.mysql.com/support/">Support</a></li>
                </ul>
            </div>

            <div class="links">
                <ul>
                    <li class="top"><a href="https://dev.mysql.com/downloads/">Downloads</a></li>
                    <li><a href="https://dev.mysql.com/downloads/mysql/">MySQL Community Server</a></li>
                    <li><a href="https://dev.mysql.com/downloads/cluster/">MySQL NDB Cluster</a></li>
                    <li><a href="https://dev.mysql.com/downloads/shell/">MySQL Shell</a></li>
                    <li><a href="https://dev.mysql.com/downloads/router/">MySQL Router</a></li>
                    <li><a href="https://dev.mysql.com/downloads/workbench/">MySQL Workbench</a></li>
                </ul>
            </div>

            <div class="links">
                <ul>
                    <li class="top"><a href="https://dev.mysql.com/doc/">Documentation</a></li>
                    <li><a href="https://dev.mysql.com/doc/refman/en/">MySQL Reference Manual</a></li>
                    <li><a href="https://dev.mysql.com/doc/workbench/en/">MySQL Workbench</a></li>
                    <li><a href="https://dev.mysql.com/doc/index-cluster.html">MySQL NDB Cluster</a></li>
                    <li><a href="https://dev.mysql.com/doc/index-connectors.html">MySQL Connectors</a></li>
                    <li><a href="https://dev.mysql.com/doc/#topic">Topic Guides</a></li>
                </ul>
            </div>

            <div class="links">
                <ul>
                    <li class="top"><a href="https://www.mysql.com/about/">About MySQL</a></li>
                    <li><a href="https://www.mysql.com/about/contact/">Contact Us</a></li>
                                                            <li><a href="https://www.mysql.com/buy-mysql/">How to Buy</a></li>
                    <li><a href="https://www.mysql.com/partners/">Partners</a></li>
                    <li><a href="https://www.mysql.com/about/jobs/">Job Opportunities</a></li>
                    <li><a href="https://www.mysql.com/sitemap.html">Site Map</a></li>
                </ul>
            </div>

            
            <div id="footer-logo">
                <a href="http://www.oracle.com/" aria-label="Oracle" title="Oracle"><span class="oracle-logo"></span></a>
                &nbsp; &copy; 2019, Oracle Corporation and/or its affiliates
                <div class="footer-legal-links">
                    <a href="https://www.mysql.com/about/legal/">Legal Policies</a> |
                    <a href="http://www.oracle.com/us/legal/privacy/index.htm">Your Privacy Rights</a> |
                    <a href="http://www.oracle.com/us/legal/terms/index.html">Terms of Use</a> |
                    <a href="http://www.oracle.com/us/legal/third-party-trademarks/index.html">Trademark Policy</a> |
                    <a href="http://www.oracle.com/technetwork/community/oca-486395.html">Contributor Agreement</a> |
                    <div id="teconsent" style="display: inline-block"><script async="async" type="text/javascript" src="js/notice.js" crossorigin=""></script></div>
                </div>
            </div>

        </div>
    </footer>
</div>

        <script src="js/s_code_remote.js"></script>

        
    
</body>
</html>
